home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / rbbs / nosnal57.zip / NOSNAIL.DOC < prev    next >
Text File  |  1992-09-12  |  45KB  |  1,255 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.              NoSnail - Netmail for RBBS-PC
  20.  
  21.  
  22.          │   Release 0.57
  23.  
  24.  
  25.          │   September 11, 1992
  26.  
  27.  
  28.              (c) Copyright Eddie Rowe (Work in Progress)
  29.                  All Rights Reserved
  30.  
  31.  
  32.              Eddie Rowe
  33.              P.O. Box 434
  34.              Ruston, LA 71273
  35.  
  36.  
  37.              HOTLine RBBS
  38.              (318)-254-0019 (v.32bis)
  39.          │   Fidonet 1:19/124 (Changing in Winter of 1992)
  40.  
  41.  
  42.          │   Revisions to this document are annontated in this
  43.          │   fashion.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.              Table of Contents
  84.  
  85.  
  86.              Copyright and License                                 1
  87.              Warranty                                              1
  88.              What is NoSnail?                                      1
  89.          │   Software Requirements                                 2
  90.              Hardware Requirements                                 4
  91.              Acknowledgments                                       4
  92.          │   Installation                                          4
  93.              Addressing Kludge                                     9
  94.              Operation                                             9
  95.              Maintenance                                          11
  96.          │   Multitasking Environments                            11
  97.              Software References                                  12
  98.              NoSnail Development                                  12
  99.              Newbees to Fidonet                                   12
  100.              Author's Commitment                                  13
  101.              Bug Reports                                          13
  102.          │   Future Enhancements                                  14
  103.              Fidonet Technical Standards Committee                15
  104.          │   History of NoSnail                                   15
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.            NoSnail 0.57                                        Page 1
  136.  
  137.  
  138.  
  139.          COPYRIGHT AND LICENSE
  140.  
  141.              NoSnail - Netmail for RBBS-PC is (c) by Eddie Rowe
  142.  
  143.              You are hereby granted a limited license to use, copy and
  144.              distribute NoSnail - Netmail for RBBS-PC on the following
  145.              conditions:
  146.  
  147.              1.  You may use this program for any non-commercial or
  148.                  commercial purpose.
  149.  
  150.              2.  You may copy and distribute as many copies of this
  151.                  program, provided you do not charge money for the
  152.                  program.  A small fee (for copying, handling,
  153.                  mailing, and the disk containing the copy) is
  154.                  allowed, but this amount shall NOT exceed your real
  155.                  costs.
  156.  
  157.              3.  The program and documentation shall NOT be modified
  158.                  in any way.  While permission is granted for the
  159.                  conversion of the distribution archive to one's
  160.                  favorite archiving format, files shall NOT be added
  161.                  or deleted from said archive.
  162.  
  163.  
  164.          WARRANTY
  165.  
  166.              No warranty of any kind is offered on NoSnail - Netmail
  167.              for RBBS-PC.  Furthermore, you use this program AT YOUR
  168.              OWN RISK.  Under no circumstances shall the author be
  169.              liable for damage this software may inflict upon your or
  170.              your property - either by itself or with your help.
  171.  
  172.  
  173.          WHAT IS NOSNAIL - NETMAIL FOR RBBS-PC
  174.  
  175.              NoSnail - Netmail for RBBS-PC allows sysops to give their
  176.              users access to routed outbound netmail (or
  177.              indiscriminate access to continuous outbound netmail
  178.              which is NOT recommended.)  Routed netmail is netmail
  179.              which is moved along existing echomail paths instead of
  180.              being sent directly to the destination system by placing
  181.              a special phone call.
  182.  
  183.              Fidonet, as well as other progressive Fidonet technology
  184.              based networks, seems to be moving more towards routed
  185.              netmail as a means to reducing cost to the network as a
  186.              whole.  The end goal of routed netmail is to encourage
  187.              participants in echos to reduce non-topical conversations
  188.              and thereby reduce the costs of moving echomail.
  189.  
  190.              Think about this:  One routed netmail message will pass
  191.              through a half-dozen nodes, whereas an off-topic echomail
  192.              message will pass through perhaps hundreds of nodes!
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.            NoSnail 0.57                                        Page 2
  202.  
  203.  
  204.  
  205.          SOFTWARE REQUIREMENTS
  206.  
  207.              RBBS-PC
  208.  
  209.          │   NoSnail has been tested with RBBS-PC 17.4 & the Maple
  210.          │   Merges. (Most recent version is 08-31)  NoSnail was
  211.          │   originally written for RBBS-PC 17.3C so it should work
  212.          │   well alongside it as I've not moved to support the carbon
  213.          │   copy features offered in 17.4.  I do NOT advocate the
  214.              usage of outdated versions of RBBS-PC, but if you find
  215.              yourself in this situation I would be happy to attempt to
  216.              create a custom version of NoSnail for you -provided you
  217.              supply the necessary specifications for your version (in
  218.              the documentation).
  219.  
  220.              MAILER
  221.  
  222.              NoSnail should work alongside ANY FTS-0001 compatable
  223.              mailer which is capable of handling messages written to
  224.              FTS-0001 standards, and does NOT rely on those written in
  225.              the *.MSG BBS format.  BinkleyTerm and Milquetoast both
  226.              operate in this fashion, while others such as Frontdoor,
  227.              Intermail and SEAdog operate differently unfortunately.
  228.  
  229.              If you operate a mailer which breaks from the ranks of
  230.              BinkleyTerm in regards to treatment of mail, I would
  231.              sincerely appreciate hearing from you the details that
  232.              are involved for this to work properly.
  233.  
  234.                   FRONTDOOR IMPLICATIONS (AND INTERMAIL, & SEADOG?)
  235.  
  236.              The authors of these packages choose to rely upon storing
  237.              messages destined to other systems in a format that is
  238.              normally reserved for a BBS - I have not the foggiest
  239.              idea why they do this....go figure....8-)
  240.  
  241.              While the *.MSG format of messages is documented in the
  242.              same document that defines the basic Fidonet standard, it
  243.              is only meant as an example to how the overall picture
  244.              COULD look like.  The *.MSG format is NOT part of the
  245.              basic Fidonet Standard and as such is subject to the
  246.              whims of anyone who writes a program to make, mangle,
  247.              manipulate, modify, etc. *.MSG messages.
  248.  
  249.              Alfred Roth of 1:387/493@fidonet.org (8:931/493@rbbsnet)
  250.              is using MAKEARC in order to compress the netmail packets
  251.              created by NoSnail and to create the necessary file
  252.              attach so Frontdoor can send the message.  If you have
  253.              further questions surrounding this setup feel free to
  254.              contact Alfred via netmail.
  255.  
  256.              Previously I mentioned a program called NOFLO, but after
  257.              taking a look at it myself I have found that it does NOT
  258.              do what I originally thought.  NOFLO will take .?LO files
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.            NoSnail 0.57                                        Page 3
  268.  
  269.  
  270.  
  271.              (BinkleyTerm uses these for file attaches) and create a
  272.              *.MSG file attatch for one of these other mailers to use.
  273.              NOFLO will NOT take a netmail message written in the
  274.              *.?UT form (FTSC-0001 compliant - i.e NoSnail's work) and
  275.              create a *.MSG!
  276.  
  277.              In order to use NOFLO, one would have to have a mail
  278.              packing program, such as OMMM, take the .?UT files and
  279.              create a bundle for the destination.  When OMMM does this
  280.              it creates the .?LO file which BinkleyTerm uses as a file
  281.              attach.  So one could use NOFLO to create a *.MSG file
  282.              attach for the above mentioned mailers to send the mail
  283.              bundle made by OMMM.  In this way the NOFLO software is
  284.              similar to the MAKEARC package, except with MAKEARC you
  285.              would ONLY have to have setup and run MAKEARC instead of
  286.              OMMM AND NOFLO.  (Anyone confused here? <grin>)
  287.  
  288.              ECHOMAIL/NETMAIL TOSSER
  289.  
  290.              NoSnail ONLY handles OUTGOING netmail messages.  In order
  291.              to process incoming netmail you will need additional
  292.              software.  There are a number pieces of software which
  293.              may be used to accomplish this.  One that I value quite
  294.              highly is RBBSMail by Jan Terpstra.  RBBSMail will place
  295.              incoming echomail messages into RBBS-PC's *M.DEF format
  296.              or the widely familar *.MSG form.  RBBSMail 18.1 will NOT
  297.              place incoming netmail messages into RBBS-PC's *M.DEF
  298.              formated message bases, but only as *.MSG messages.
  299.  
  300.          │   Jan Terpstra is developing RBBSMail 18.2 currently and
  301.          │   I am VERY IMPRESSED with the Beta code that I am running.
  302.          │   Jan has just released a Wide Beta of RBBSMail 18.2 so the
  303.          │   anticipated release of RBBSMail 18.2 is not far away!
  304.          │   RBBSMail 18.2 will be placing inbound netmail into the
  305.          │   *M.DEF of your choice.
  306.  
  307.              I feel it only fair to mention the existence of other
  308.              known software which are currently well supported in the
  309.              RBBS-PC community from conversations in the RBBS-PC echo.
  310.              MSGTOSS will process echomail, and will also toss
  311.              inbound netmail into the *M.DEF of your choice.  OVERMAIL
  312.              will process echomail, place incoming netmail into the
  313.              *M.DEF of your choice, and has been rumored recently of
  314.              allowing some type of outbound netmail access.  Beyond
  315.              this information I do not have first hand experience with
  316.              either package.
  317.  
  318.                   IMPLICATIONS OF MSGTOSS
  319.  
  320.              Jim Wargula of 1:121/1@fidonet.org uses MSGTOSS happily
  321.              alongside NoSnail on his system.  From my conversations
  322.              with Jim, it seems to only be a matter of configuring
  323.              MSGTOSS to place inbound netmail messages into the *M.DEF
  324.              message base of your choice, but to someone new to all of
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.            NoSnail 0.57                                        Page 4
  334.  
  335.  
  336.  
  337.              this it may be a bit more difficult to implement.  If you
  338.              would like further information on his setup feel free to
  339.              contact Jim via netmail.
  340.  
  341.              PREFERENCES
  342.  
  343.              I personally find both BinkleyTerm and RBBSMail to have
  344.              the same spirit about them as RBBS-PC.  In addition to
  345.              this, both of these authors are BIG supporters of the
  346.              Standards set forth by the Fidonet Technical Standards
  347.              Committee.  Authors such as these make it easier to write
  348.              programs to supplement their work, while others make life
  349.              difficult because they want to do it their way.  Some of
  350.              you know the very persons I am referring to and I don't
  351.              understand for the life of me WHY you use their products
  352.              - but I'll let you pick your own poison.  8-)
  353.  
  354.  
  355.          HARDWARE REQUIREMENTS
  356.  
  357.              There should be no hardware requirements in excess of
  358.              those you are currently operating under with RBBS-PC.  To
  359.              quote Jan Terpstra, "think about that for a while....".
  360.  
  361.  
  362.          ACKNOWLEDGMENTS
  363.  
  364.              Tom Jennings - creator of Fidonet
  365.  
  366.              The BinkleyTerm Trio
  367.  
  368.              The RBBS-PC community.
  369.  
  370.              Bruce Gingery for his aid in my grasping the concept of
  371.              Big Indian - Little Indian when it comes to programming.
  372.  
  373.              Randy Bush for putting on "paper" exactly what authors of
  374.              Fidonet technology software have implemented and his
  375.              netmail from around the world in answer to my questions.
  376.  
  377.              Participants of NET_DEV echo for their insights.
  378.  
  379.              Dennis Dodd for his aid in helping me to understand how
  380.              to properly use DOS interrupts. (still in amazement)
  381.  
  382.  
  383.          INSTALLATION
  384.  
  385.              Step 1 - RBBS-PC SETUP
  386.  
  387.              First you need to create an area for users to enter their
  388.              netmail messages.  I HIGHLY recommend the use of NETMAIL
  389.              as your conference/subboard name for this area for the
  390.              sake of simplicity.  While this area should be configured
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.            NoSnail 0.57                                        Page 5
  400.  
  401.  
  402.  
  403.              like your other conferences/subboards, it should NOT
  404.              necessarily be in your AREAS.BBS control file used by
  405.          │   your echomail scanner/tosser - I can say for sure that
  406.          │   this area should be declared as your XNETMAIL area in the
  407.          │   RBBSMail 18.2wb AREAS.BBS.
  408.  
  409.              WARNING:  Do NOT use CONFIG on the message base used by
  410.              NoSnail under ANY circumstances!  NoSnail is presently
  411.              following Jan Terpstra's (RBBSMail) lead in the method in
  412.              which it marks messages as already exported.  (The ":"
  413.              field between the minutes and seconds is modified to a
  414.              "." after exportation.)
  415.  
  416.              If you are attempting to use NoSnail with ANY version of
  417.              RBBS-PC greater than 17.3C, DO NOT ALLOW MULTIPLE MESSAGE
  418.              HEADERS (i.e. Carbon Copies) in the area you setup for
  419.              NoSnail!!!  If you choose to allow these in your MAIN
  420.              area, then you MUST setup the NETMAIL area as a Subboard
  421.              with these DISABLED!!!
  422.  
  423.              Step 2 - NOSNAIL.CFG
  424.  
  425.          │   NoSnail's configuration file format is much like that of
  426.          │   other Fidonet utilities in that it operates on the
  427.          │   keyword format.  Lines beginning with a semi-colon are
  428.          │   ignored as well as blank lines.  You may also have a
  429.          │   comment after a configuration option provided there is a
  430.          │   semi-colon between the phrase and your comment.  The
  431.          │   sample configuration included in the archive demonstrates
  432.          │   all the variations on comments which are possible.
  433.          │
  434.          │   Valid NOSNAIL.CFG phrases:
  435.  
  436.          │   SYSOP
  437.  
  438.              This is the name you wish to have swapped for messages
  439.              sent by "SYSOP".  Obviously this should be your PUBLIC
  440.              NAME, but could be an assumed name - whatever floats your
  441.              boat.  DO NOT PUT YOUR SECRET NAME THAT YOU USE TO LOGON
  442.              REMOTELY FOR THIS PARAMETER!!!
  443.  
  444.              A word of warning here for those with CoSysops.  Make
  445.              sure that none of them have "SYSOP" status in the NETMAIL
  446.              area or they might be sending message out with YOUR name
  447.              on them.  I don't think this very likely (in fact I deem
  448.              it almost impossible), but I don't do cosysops myself.
  449.  
  450.          │   Note:  This parameter is required.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.            NoSnail 0.57                                        Page 6
  466.  
  467.  
  468.  
  469.          │   MSGBASE
  470.  
  471.              This is the RBBS-PC *M.DEF message base which contains
  472.              your netmail messages.  This is the messages file that
  473.              you created in Step 1 above.  (If you followed my
  474.              suggestion to K.I.S.S. this would be NETMAILM.DEF...)
  475.  
  476.          │   Note:  This parameter is required.
  477.  
  478.          │   ELVISMODE
  479.  
  480.              If there are problems with the exportation of a netmail
  481.              message  (ie the user used some ungodly syntax for the
  482.              address) you can have NoSnail return a copy of the failed
  483.              message to the sender.  NoSnail will attempt to shell out
  484.              and run MSGFORM to bounce the message back to its sender.
  485.              (There are few things as humorous as users getting canned
  486.              mail!  <grin> )
  487.  
  488.          │   Note:  This parameter is optional.
  489.  
  490.          │   EXPLETIVE
  491.  
  492.              Since you will eventually tuck NoSnail away in some
  493.              obscure batch file and not be around when it runs, I've
  494.              included the Error Explitive.  NoSnail will place
  495.              this in front of any error messages - providing colorful
  496.              feedback even while you are not around!  I suggest you
  497.              don't get too carried away here, or your log file will
  498.              look very weird.
  499.  
  500.          │   Note:  This parameter is required.
  501.  
  502.          │   ADDRESS
  503.  
  504.              This is your default Fidonet address.  It MUST be in the
  505.              form of "Zone:Network/Node".  Additionally if you are
  506.              operating as a point, NoSnail will accept a 4D address of
  507.              "Zone:Network/Node.Point".
  508.  
  509.           │  Note:  This parameter is required.
  510.  
  511.           │  FLAVOR
  512.  
  513.              This controls what extension NoSnail uses for the netmail
  514.              packet.  BinkleyTerm uses this to determine what "kind"
  515.              of message it is.  The PREFERRED extension is "OUT".
  516.              These are documented in the BinkleyTerm and OMMM
  517.              documentation if you wonder where the heck I found out
  518.              what they are.
  519.  
  520.                  OUT -  Normal ; This means that the netmail has not
  521.                  been processed by any of the mail archiving/routing
  522.                  software.  It is my understanding that if you do not
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.            NoSnail 0.57                                        Page 7
  532.  
  533.  
  534.  
  535.                  run any software on this file that it will be treated
  536.                  as a DUT (described below).  I have BinkleyTerm
  537.                  configured on my system to NOT dial out for Normal
  538.                  packets - I HIGHLY recommend you do the same.
  539.  
  540.                  HUT - Hold ; This means that the netmail will not be
  541.                  sent to the destination system, but instead will hang
  542.                  around until that system calls you.
  543.  
  544.                  CUT - Continuous Mail ; This means that the netmail
  545.                  will be sent directly to the destination system.
  546.                  WARNING: THIS WILL COST YOU THE EXPENSE OF A PHONE
  547.                  CALL!!!
  548.  
  549.                  DUT - Direct ; This means that the netmail will be
  550.                  sent directly to the destination system.  This
  551.                  extension is used for those systems who do NOT
  552.                  operate a mailer except during Zone Mail Hour.
  553.                  WARNING:  Packets with this extension have the
  554.                  potential to COST YOU THE EXPENSE OF A PHONE CALL!!!
  555.  
  556.            │ Note:  This parameter is required.
  557.  
  558.            │ OUTBOUND
  559.  
  560.              This is your default outbound area which should
  561.              correspond to the Zone of your default Fidonet address.
  562.              NOTE: THIS LINE MUST _NOT_ END WITH A "\" CHARACTER!
  563.              NoSnail will take care of adding that character on its
  564.              own.
  565.  
  566.            │ Note:  This parameter is required.
  567.  
  568.            │ AKA1, AKA2, AKA3, ... AKA9
  569.  
  570.              Since some people have brain seizures when they receive
  571.              mail from a different network than the one they are a
  572.              member of, I've implemented AKA matching.  NoSnail
  573.          │   supports up to NINE AKAs.  Place your additional
  574.              addresses in the proper "Zone:Net/Node.Point" format.
  575.  
  576.              AKAs are matched in order of appearance in NOSNAIL.CFG.
  577.              NoSnail will automatically use an AKA for a message to
  578.              a Zone which you have an AKA defined.  The NOSNAIL.LOG
  579.              displays what address (or AKA) was used on each message
  580.              exported for additional error checking.
  581.  
  582.          │   Note:  These parameters are optional.
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.            NoSnail 0.57                                        Page 8
  598.  
  599.  
  600.  
  601.          │   INTL
  602.          │
  603.          │   The ^aINTL kludge is documented for INTERZone mail in
  604.          │   FTS-0001, but some authors may rely on the line to route
  605.          │   all their mail.  QMail is the only package I know of to
  606.          │   require this control line.  If your software does NOT
  607.          │   require this please do _NOT_ use it!!!
  608.          │
  609.          │   Note:  This parameter is optional.
  610.  
  611.              Step 3 - OUTBOUND DIRECTORIES
  612.  
  613.              You must have an outbound directory for EVERY Zone you
  614.              will intend to send netmail.  In our example here, Zone 1
  615.              mail would be placed in the OUTBOUND directory, Zone 2
  616.              mail would be placed in the OUTBOUND.002 directory, Zone
  617.              8 mail would be placed in the OUTBOUND.008 directory,
  618.              etc.  Undoubtedly you already have the proper directories
  619.              defined for the Zones you send mail to on a regular
  620.              basis, but remember that some networks such as Fidonet
  621.              are so large that there are various additional zones
  622.              within the network.
  623.  
  624.              Note:  The OUTBOUND directories for multiple zone support
  625.              are numbered in HEXIDECIMAL, NOT just plain jane decimal!
  626.  
  627.              Step 4 - NOSNAIL PLACEMENT
  628.  
  629.              While personally I like to place NoSnail & its config
  630.              file in the RBBS subdirectory, many are placing NoSnail
  631.              elsewhere and supplying a full path to the NETMAIL
  632.              message base (NETMAILM.DEF is you followed my lead).
  633.  
  634.              Step 5 - MSGTOSS PLACEMENT (optional)
  635.  
  636.              If you enabled ElvisMode you need to place a copy of
  637.              MSGFORM in the directory with NoSnail or the DOS path.
  638.  
  639.              Step 6 - HELP FILES
  640.  
  641.              Take a look at the included help files that I have
  642.              created to help my users properly send netmail to
  643.              destinations unknown.  These belong with your other help
  644.              files.  If you are operating in Fidonet, then EDIT the
  645.              help file to reflect the gateway you must use for sending
  646.              netmail to Internet domains.(i.e. Compuserve, MCIMail)
  647.  
  648.              To my knowledge Fidonet is the ONLY Fidonet technology
  649.              network which is part of Internet, but this may be
  650.              incorrect.  Persons outside of Fidonet may NOT be able to
  651.              give their users the okay to send mail to people on
  652.              Internet, Compuserve, MCIMail, etc.  Contact your network
  653.              coordinator (or Boss Node) for aid in determining this,
  654.              and feel free to enlighten me if I am wrong.
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.            NoSnail 0.57                                        Page 9
  664.  
  665.  
  666.  
  667.              Step 7 - MAIL DOOR SUPPORT  (optional)
  668.  
  669.              Just about everyone and their brother has jumped on the
  670.              mail door bandwagon.  Be sure to configure your mail door
  671.              to allow access to this area so that your offline users
  672.              can enter netmail messages.  Actually this is the main
  673.              reason for this product.  It is SO EASY to reply to
  674.              echomail posts via netmail if the reply is not
  675.              appropriate for the echo!  If you have no idea what a
  676.              mail door can do for you, I need to talk to you!
  677.  
  678.  
  679.          ADDRESSING KLUDGE
  680.  
  681.              RBBS-PC currently does not support a method for entering
  682.              netmail addresses.  NoSnail makes use of a special kludge
  683.              to allow netmail to be sent.  NoSnail uses the Subject
  684.              line of messages in the NETMAIL area as the address field
  685.              of the message.  The address should be in the form of
  686.              "Zone:Network/Node.Point".  I have purposely not tampered
  687.              with the text of the message like the gateway software
  688.              presently does (such as UFGATE).  I think it best for me
  689.              to leave well enough alone at this point in time.
  690.  
  691.              I STRONGLY wish to move the addressing information out of
  692.              the subject field.  I hesitate to make things more
  693.              difficult and would like to hear your opinion.  The main
  694.              reason for desiring to move it is so I can implement
  695.              DOMAIN support in the future - there is NOT enough room
  696.              in the subject field.  One alternative would be to use
  697.              the first line of the message text as the addressing
  698.              field.  The other alternative (the preferred) would be to
  699.              modify RBBS to properly support echomail/netmail.
  700.  
  701.              I've recently been in contact with Jan Terpstra via
  702.              echomail and it seems he has sat down to think out new
  703.              message/user base structures which would allow for the
  704.              proper echomail/netmail support that RBBS needs so badly.
  705.              Per our conversations this not only includes structures,
  706.              but necessary documentation of the structures and
  707.              conversion programs for updating.  Jan first proposed
  708.              such structures in 1988 and again in 1990, but this is
  709.              the first I've heard of this.  I would very much like to
  710.              see RBBS become echomail/netmail friendly.
  711.  
  712.  
  713.          OPERATION
  714.  
  715.              Undoubtedly you will want to enter a message or two and
  716.              put NoSnail through a test on your system PRIOR to
  717.              putting it in an obscure batch file to ensure it behaves
  718.              properly under your setup.  I recommend you also botch an
  719.              address on purpose to see how MSGFORM performs if you
  720.              have enabled ElvisMode.
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.           NoSnail 0.57                                        Page 10
  730.  
  731.  
  732.  
  733.              NoSnail reads its configuration file, looks for new
  734.              messages in the NETMAIL message base, and exports them
  735.              out as netmail messages.  (Obviously NoSnail also marks
  736.              the messages as sent to prevent duplicates from being
  737.              sent.)
  738.  
  739.              If NoSnail has problems exporting the message due to the
  740.              outbound directory not existing or the address being in
  741.              the improper format, it will attempt to recover from the
  742.              error, mark the message as sent, and move on to any
  743.              additional messages which may exist.  (If you have
  744.              enabled ElvisMode, NoSnail runs MSGTOSS before moving on
  745.              to the next message for processing so the sender can be
  746.              alerted to the problem.)
  747.  
  748.              I recommend you place NoSnail in your batch file which
  749.              processes echomail/netmail PRIOR to your echomail
  750.              scanner/tosser.  Why?  Close scrutiny of RBBSMail
  751.              operation reveals that RBBSMail makes its modification to
  752.              the time field (remember the ":" to ".") when it tosses
  753.              the incoming mail.  Since it is expected that RBBSMail
  754.              will soon support importation of netmail into the *M.DEF
  755.              file, it is saving yourself potential grief by making
  756.              sure the mail that needs to be exported is in fact
  757.              exported. (An ounce of prevention never hurt anyone.)
  758.              Additionally, I have no idea how MSGTOSS and OVERMAIL
  759.              deal with the time field, and I don't want mail to become
  760.              orphaned on your system!
  761.  
  762.                   ELVISMODE
  763.  
  764.              If you configured NoSnail to operate in ElvisMode
  765.              NoSnail will send a message to the user when they botch
  766.              the netmail address, or when the packet writing process
  767.              fails (usually this is when the zone of the message is
  768.              NOT a valid zone - i.e.  you do not have an outbound
  769.              directory for that zone.)  NoSnail does this by simply
  770.              shelling to DOS and calling MSGFORM with the following
  771.              parameters:
  772.  
  773.              MSGFORM /LTR:NOSNAIL.LTR /MSG:%1 /PRI /NET /TO:%2
  774.  
  775.              In place of %1 NoSnail puts the message base name you are
  776.              using for your NETMAIL area (NETMAILM.DEF right?) and in
  777.              place of %2 it puts the name found in the FROM field of the
  778.              message it gagged on.
  779.  
  780.              Immediately after running MSGFORM NoSnail nukes the
  781.              NOSNAIL.LTR file which was written by NoSnail.
  782.  
  783.              I only have a copy of MSGFORM 1.1 so I cannot say if it
  784.              works with prior versions or future versions.  If you run
  785.              into problems LET ME KNOW, and DISABLE this feature by
  786.              removing "ElvisMode" from your NOSNAIL.CFG.
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.           NoSnail 0.57                                        Page 11
  796.  
  797.  
  798.  
  799.          MAINTENANCE
  800.  
  801.              NoSnail does not require any extra maintenance beyond a
  802.              normal echomail area.  Since it follows RBBSMail's lead
  803.              in the manner of marking messages as exported, virtually
  804.              ANY message purge utility may be run on the NETMAIL
  805.              message base from time to time to keep it trimmed to a
  806.              reasonable size.  (Now, say it with me, "DON'T USE
  807.              CONFIG UNDER ANY CIRCUMSTANCES!")
  808.  
  809.              As far as I know, CONFIG and MU-PURGE are the only two
  810.              message base utilities which are guaranteed to cause you
  811.              grief if used on a message base processed by RBBSMail.
  812.              These WILL also cause you grief if you run them on the
  813.              message base maintained by NoSnail!!!
  814.  
  815.              Users of RBBSMail will want to make use of RBBSMNT
  816.              because it will be of special value to them when RBBSMail
  817.              18.2 is released (plus it is in the same spirit as
  818.              RBBSMail).  I also have firsthand experience with Chip
  819.              Morrow and Doug Wilson's MAILFIX program - included in
  820.              the Mail Manager .QWK program archive.
  821.  
  822.              Users of MSGTOSS should not have any problems using
  823.              MSGTOSS to purge the NETMAIL message just like they do
  824.              any other echomail area.
  825.  
  826.              You might also consider the HUH? and RTMBP packages to
  827.              take care of maintanance on your netmail area.  Both of
  828.              these have been praised in the RBBS-PC echo, but I do NOT
  829.              have any first hand experience with either package.
  830.  
  831.  
  832.          MULTITASKING ENVIRONMENTS
  833.  
  834.              There is NO support in NoSnail for those who multitask or
  835.              operate under network environments other than the message
  836.              base being opened in SHARED mode.  One should always
  837.              assume this when it comes to running software, but in
  838.              case you assume the reverse, you ARE WRONG and cruising
  839.              for a bruising!  8-)
  840.  
  841.          │   I have just finished migrating to DESQview 386 on the
  842.          │   BBS.  I am running NoSnail in the same window that I
  843.          │   run Binkley and RBBS and have not ran into any
  844.          │   difficulties.  In fact I am running everything under
  845.          │   DESQview on the BBS without any problems.
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.           NoSnail 0.57                                        Page 12
  862.  
  863.  
  864.  
  865.          SOFTWARE REFERENCES
  866.  
  867.              Throughout this document I've dropped the names of
  868.              various pieces of software.  These should be readily
  869.              available to you on major BBSs around the United States
  870.              and Europe.  In  the event you cannot find them
  871.              locally/easily I've got them online.  I have NO idea if
  872.              these are the newest versions of these programs (actually
  873.              I do know about a few of them).  These should all be
  874.              FREQable and/or downloadable as personal downloads using
  875.              the NOSNAIL LATEST VERSION scheme.  (You can manually log
  876.              onto my system as the name NOSNAIL LATEST and the
  877.              password VERSION to access my personal file directory.)
  878.              If you don't operate in Fidonet never fear!  I don't turn
  879.              down File Requests from anyone - that is about as brain
  880.              dead as you can get IMHO.
  881.  
  882.              If I missed listing any, drop me a note and I'll correct
  883.              the oversight.  No, I don't keep any mailers online.
  884.  
  885.              FTS-0001.A15  25k  Basic Fidonet Technology Specification
  886.              HUH200.ZIP    35k  HUH? - *M.DEF message base utility
  887.              MAILFIX.ZIP   12k  MAILFIX - *M.DEF message base utility
  888.              MAKEARC3.ZIP  44k  MAKEARC - Mail masher
  889.              MNT-201.ZIP   46k  RBBSMNT - *M.DEF message base utility
  890.                                 by Jan Terpstra
  891.              MSGFRM11.ZIP  40k  MSGFORM - need to use ElvisMode
  892.              NOFLO100.ZIP  22k  NOFLO - Converts *.?LO to *.MSG file
  893.                                 attaches
  894.              OMMM_170.ZIP  91k  OMMM - Mail masher of sorts (this is
  895.                                 the one I use to route my .OUT netmail
  896.                                 packets to my echomail host )
  897.              RMAIL181.ZIP  82k  RBBSMail Echomail processor
  898.                                 by Jan Terpstra
  899.              RTMBP200.ZIP  65k  RBBS TURBO MESSAGE BASE PACKER -
  900.                                 *M.DEF message base utility
  901.  
  902.  
  903.          NOSNAIL DEVELOPMENT
  904.  
  905.              NoSnail has been developed under Digital Research's
  906.              Superior Disk Operating System (version 6.0) and under
  907.              Micro$oft's Professional Development System 7.1 (just
  908.              another fancy name for an overpriced version of Basic).
  909.  
  910.  
  911.          NEWBEES TO FIDONET
  912.  
  913.              If you've made it this far in the documentation and are
  914.              totally confused with things, DO NOT GIVE UP!  This
  915.              document makes a lot of broad assumptions in regards to
  916.              the operation of RBBS-PC in a Fidonet technology
  917.              environment.  If you need help I am here to lend a
  918.              helping hand.  (not to mention the outstanding group of
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.           NoSnail 0.57                                        Page 13
  928.  
  929.  
  930.  
  931.              people in the RBBS-PC echo)  Please refer to the
  932.              beginning of this document for addressing information.
  933.              If you insist on sending SnailMail, I would appreciate a
  934.              S.A.S.E. for a reply.
  935.  
  936.              I'll be revising this document from time to time to
  937.              enhance its readability and clarity.  The only way I'll
  938.              know I botched an explanation will be for you to let me
  939.              know.
  940.  
  941.  
  942.          AUTHOR'S COMMITMENT
  943.  
  944.              I will be honest and make no promises that I cannot
  945.              deliver upon.  I wish I were a more seasoned programmer,
  946.              but alas I am not so I poke along with BIG ideas and a
  947.              BIG learning curve.  If you use the software I would like
  948.              to hear from you, particularly since I consider this a
  949.              product under development.
  950.  
  951.  
  952.          BUG REPORTS
  953.  
  954.              If you experience any difficulty with NoSnail, strip your
  955.              system of any software which may be resident and
  956.              potentially causing conflicts.  If you ARE able to point
  957.              the finger at a TSR or device driver, please pass this
  958.              information on to me so I can document it and attempt to
  959.              remedy.  If the item is a shareware product which would
  960.              allow you to send me a copy, please do.  If not please
  961.              supply me with complete information as to the name &
  962.              version of the software and the address & phone number of
  963.              the author.
  964.  
  965.              If you are unable to point the finger at anything on your
  966.              system, then it is time to let me try to duplicate it
  967.              here.  In order for me to do this I will need the
  968.              following as a minimum:
  969.  
  970.                   1.  DOS manufacturer and version
  971.                   2.  Machine type (microprocessor), manufacturer,
  972.                       bios manufacturer & date
  973.                   3.  Environment under which you operate.
  974.                   4.  Copy of your AUTOEXEC.BAT and CONFIG.SYS
  975.                   5.  NOSNAIL.CFG
  976.                   (continued on next page....)
  977.                   6.  Messages file (NETMAILM.DEF)
  978.                   7.  Outbound packets (if trashed or improper)
  979.                   8.  *.MSG files (if the message was bounced back to
  980.                       you for some reason)
  981.                   9.  Complete details as to what is wrong, how
  982.                       discovered, and attempted futile remedies.
  983.  
  984.              Archive the various files into a unique archive which
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.           NoSnail 0.57                                        Page 14
  994.  
  995.  
  996.  
  997.              includes your node address as part of the name if you
  998.              have an address, else dream something up.  Be sure to
  999.              also include a file with the output redirected to a text
  1000.              file also. (i.e. run Nosnail with this command line:
  1001.              "NoSnail > Error.rpt")
  1002.  
  1003.  
  1004.          FUTURE ENHANCEMENTS
  1005.  
  1006.              For those that are curious, here are my tentative future
  1007.              plans:
  1008.  
  1009.              Note:  Not in any order really....
  1010.  
  1011.              1.  Continue to squash any buglets which spring up and
  1012.                  a continued optimization of the code for efficiencies
  1013.                  sake - no sense getting sloppy.
  1014.  
  1015.          │   2.  Implement support for *.MSG users
  1016.  
  1017.              3.  Implement full support for FSC-0045
  1018.  
  1019.              4.  Gain a better understanding of how the various
  1020.                  Fidonet technology mailers operate.
  1021.  
  1022.              5.  Develop a way to allow users to have some sort of
  1023.                  account balance where they could send Continuous mail
  1024.                  if they have prepaid the sysop.  (Jan Terpstra's
  1025.                  proposal for modifying RBBS might do the trick here.)
  1026.  
  1027.              6.  Develop a way to use the compiled nodelist. (Version
  1028.                  7)  It seems that there is currently not a lot of
  1029.                  information available to programmers, especially
  1030.                  those who do not program in C and understand it.
  1031.                  There are current efforts in the NET_DEV echo to find
  1032.                  someone who will spill the beans.
  1033.  
  1034.              7.  Interface NoSnail with RBBS via a merge which would
  1035.                  allow users to use the compiled nodelist and give
  1036.                  online verification of exportation.  This is a hairy
  1037.                  one!
  1038.  
  1039.              8.  Work with other Fidonet technology software authors
  1040.                  in a common goal of updating the basic Fidonet
  1041.                  technology standard.  This is a goal of a number of
  1042.                  people around the world, but with many problems.  The
  1043.                  goal is to upgrade the standard without breaking all
  1044.                  of the software that is currently being used.
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.           NoSnail 0.57                                        Page 15
  1060.  
  1061.  
  1062.  
  1063.          FIDONET TECHNOLOGY STANDARDS COMMITTEE
  1064.  
  1065.              NoSnail adheres to FTS-0001 which is the basic Fidonet
  1066.              standard.  If my messages can get past Randy Bush's
  1067.              system, then they should be well within specs in my
  1068.              opinion. (Rest easy...I've looked at the files with a
  1069.              HEX editor until I am blue in the face.  The test with
  1070.              Randy's system was just so I sleep better at night.
  1071.              Those of you who like me have used Amax to attempt to
  1072.              send netmail to Europe from North America through the
  1073.              gateway know what happens.)
  1074.  
  1075.              Many sysops have no idea what exactly the FTSC does.
  1076.              I've enclosed a text file (FTSC.DOC) of a message
  1077.              recently entered in the NET_DEV echo clarifying what
  1078.              exactly the "job" of FTSC is.  Rick Moore is current FTSC
  1079.              chair.  I think all of us who operate in the realm of
  1080.              Fidonet Technology should become more aware of how things
  1081.              operate on the techie side of the family.
  1082.  
  1083.  
  1084.          HISTORY OF NOSNAIL
  1085.  
  1086.          .57 September 11, 1992
  1087.  
  1088.              Corrected an error in type two packet as determined by
  1089.              MsgTrack
  1090.  
  1091.          .56 September 11, 1992 (pre-released at FidoCon)
  1092.  
  1093.              Optimized & streamlined code
  1094.  
  1095.              AKAs increased from THREE to NINE
  1096.  
  1097.              NOSNAIL.CFG now operates on keywords
  1098.  
  1099.              Support of FTS-0009's MSGID added for reply linking
  1100.  
  1101.              INTL kludge for INTRAZone mail
  1102.  
  1103.  
  1104.          .55 July 3, 1992
  1105.  
  1106.              NETMAIL Message Base now opened in SHARED Mode
  1107.  
  1108.              Conversion of ALL CAPS names fields to proper case - no
  1109.              more getting hatemail about the ALL CAPS headers from
  1110.              non-RBBS systems!  But will I now get it from those with
  1111.              "nonstandard" names???  8-)
  1112.  
  1113.              Stripped out support for FSC-0039 proposal - messages are
  1114.              now FTSC-0001 by default
  1115.  
  1116.              Support for up to three AKAs
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.           NoSnail 0.57                                        Page 16
  1126.  
  1127.  
  1128.  
  1129.  
  1130.              Improved local display for the red-eyed sysop
  1131.  
  1132.              Error Explitive Added
  1133.  
  1134.              Elvis Mode Added (RTS- return to sender with MSGFORM)
  1135.  
  1136.              NoSnail's Log file now a bit more verbose
  1137.  
  1138.              Changed from the QuickBasic 4.5 compiler to the PDS 7.1
  1139.              compiler - including a 286 machine specific version
  1140.  
  1141.  
  1142.          0.52ß  May 6, 1992 - Maintenance Release
  1143.  
  1144.              Fixed a problem dealing with killed messages which had
  1145.              not been packed yet.  This caused NoSnail to appear to be
  1146.              locked up, but which was caught in an infinite loop or
  1147.              caused NoSnail to not be able to export messages after
  1148.              killed messages.  No implications on message bases packed
  1149.              regularly as far as I know.  Hats off to Ken Humrich,
  1150.              Andrew Hart, Jim Wargula for their aid as this was a
  1151.              VERY difficult to fix since I could not duplicate at
  1152.              first...Ken's message base did the trick for me.
  1153.  
  1154.              Enhanced NoSnail to include its very own logfile so that
  1155.              output from running could be separated from bare
  1156.              necessity information for a logfile.  (Plus it is kinda
  1157.              cheasy to redirect output. <grin>)
  1158.  
  1159.  
  1160.          0.51ß  April 27, 1992 - Maintenance release.
  1161.  
  1162.              Fixed incorrect implementation of multiple zone outbound
  1163.              subdirectories.  These direcories have to be named in
  1164.              hexidecimal, not decimal as initially implemented.
  1165.  
  1166.              Fixed flaw in logic for creating hexidecimal net/node
  1167.              address from a decimal value when the network or node
  1168.              number get to four digits in length.
  1169.  
  1170.              Enhanced error checking so that errors resulting from
  1171.              messages entered with an incorrect address are hopefully
  1172.              recoverable and processing can continue.  (This goes for
  1173.              messages entered with illegal characters in the subject
  1174.              field - ie text, and messages for zones for which no
  1175.              outbound subdirectory exists.)
  1176.  
  1177.              Added a public sysop name field to configuration file so
  1178.              that the sysop's public name is used in the exported
  1179.              netmail message.
  1180.  
  1181.  
  1182.          0.50ß  April 21, 1992 - First public beta released.
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.           NoSnail 0.57                                        Page 17
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.          0.40ß  March 16, 1992 - First in-house beta for users of
  1198.                                      HOTLine RBBS.
  1199.  
  1200.          0.00   November 1991  - Idea conceived for NoSnail
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.